Table of Contents

IDE User Guide Overview

Read the Release Notes!

Manual Conventions

Typographical Conventions

Host Conventions

Figure Conventions

Keyboard Conventions

CodeWarrior Year 2000 Compliance

New in This Release

Rapid Application Development Tools

New Command

IDE Customization

Key Binding Improvements

Project Import/Export with XML

Debugger Auto-Variables View

User-Defined Trees in Access Paths

Project Window Improvements

Where To Go From Here

QuickStart and Tutorials

Targeting Documentation

Windows

Mac OS

Solaris

Linux

CodeWarrior IDE Installation

Programming Concepts

Creating Input Files

Generating the Software

Debugging and Refining

An Introduction to the CodeWarrior IDE

Projects and Targets

Source Code Editing and Browsing

Compiling and Linking

Project Debugging

Rapid Application Development

Version Control

Scripting

Customizing the IDE

Working with Third-Party Tools

Navigating the Project Window

Project Window Toolbar

Files View

Design View

Link Order View

Targets View

Creating a New Project

Types of Project Files

Choosing a Project Stationery File

Naming Your New Project

Using the New Project dialog box

Modifying Your New Project

Building Your New Project

Working with Project Stationery

About Project Stationery

About the Project Stationery Folder

Creating Your Own Project Stationery

Importing Makefiles into Projects (Windows)

Using the Makefile Importer Wizard

Makefile Importer Options

Opening an Existing Project

Using the Open Command

Using the Open Recent Command

Using the Project Window to Open Subprojects

Opening Project Files Created on Other Host Platforms

Opening Project Files from Earlier IDE Versions

Saving a Project

Items Saved with Your Project

Saving a Copy of Your Project

Closing a Project

Choosing a Default Project

Managing Files in a Project

Expanding and Collapsing Groups

Selecting Files and Groups

Adding Files

Moving Files and Groups

Creating Groups

Removing Files and Groups

Renaming Groups

Touching and Untouching Files

Working with Complex Projects

What is a Build Target?

What is a Subproject?

What is a Design?

Strategy for Creating Complex Projects

Creating a New Build Target

Changing a Build Target Name

Changing the Build Target Settings

Setting the Current Build Target

Creating Build Target Dependencies

Assigning Files to Build Targets

Creating Subprojects Within Projects

Examining Project Information

Moving a Project

Importing and Exporting a Project

Controlling Debugging in a Project

Activating Debugging for a Project

Activating Debugging for a File

Adding Preprocessor Symbols to a Project

Opening an Existing File

Opening Files from the File Menu

Opening Files from the Project Window

Opening Files from an Editor Window

Opening a Related File

Saving a File

Closing a File

Closing One File

Closing All Files

Printing a File

Setting Print Options

Printing a Window

Reverting to a Previously-Saved File

Comparing and Merging Files & Folders

File Comparison and Merge Overview

Choosing Files To Compare

Examining and Applying Differences

Choosing Folders To Compare

Text Editing Area

Interface Pop-Up Menu

Routine Pop-Up Menu

Marker Pop-Up Menu

Options Pop-Up Menu

VCS Pop-Up Menu

File Path Caption

Dirty File Marker

Pane Splitter Controls

Line Number Button

Toolbar Disclosure Button

Path Pop-Up Menu (Mac OS)

Editor Window Configuration

Setting Text Size and Font

Seeing Window Controls

Splitting the Window into Panes

Saving Editor Window Settings

Basic Text Editing

Basic Editor Window Navigation

Adding Text

Deleting Text

Selecting Text

Moving Text (Drag and Drop)

Using Cut, Copy, Paste, and Clear

Balancing Punctuation

Shifting Text Left and Right

Undoing Changes

Controlling Color

Navigating the Text

Finding a Routine

Adding, Removing, and Selecting a Marker

Opening a Related File

Going to a Particular Line

Using Go Back and Go Forward

Configuring Editor Commands

Opening a File's Directory (Mac OS)

Online References

Finding Symbol Definitions

WinHelp (Windows)

QuickHelp (Mac OS)

QuickView (Mac OS)

THINK Reference (Mac OS)

Inserting Routine (Reference) Templates (Mac OS)

HyperHelp (Solaris)

Find and Replace Section

Multi-File Search Section

Searching for Selected Text

Finding and Replacing Text in a Single File

Finding Search Text

Controlling Search Range in a Single File

Controlling Search Parameters

Searching with Special Characters

Replacing Found Text

Using Batch Searches

Finding and Replacing Text in Multiple Files

Activating Multi-File Search

Choosing Files to be Searched

Saving a File Set

Removing a File Set

Controlling Search Range in Multiple Files

Using Regular Expressions (grep)

Special Operators

Using Regular Expressions

Understanding the Browser Strategy

Contents View

Browser View

Hierarchy View

Guided Tour of the Browser

Browser Contextual Menu

Contents Window

Browser Window

Multi-Class Hierarchy Window

Single-Class Hierarchy Window

Symbol Window

Browser Menu

Browser Wizards

New Class Wizard

New Member Function Wizard

New Data Member Wizard

Using the Browser

Setting Browser Options

Identifying Symbols in the Browser Database

Navigating Code in the Browser

Browsing Across Subprojects

Completing Symbols

Opening a Source File

Seeing a Declaration

Seeing a Routine Definition

Editing Code in the Browser

Analyzing Inheritance

Finding Functions That Are Overrides

Viewing MFC and PowerPlant Classes

Saving a Default Browser

Preference Panels

Dialog Box Buttons

Choosing Preferences

General Preferences

Editor Preferences

Debugger Preferences

Customizing the IDE

Dialog Box Buttons

Customizing Commands

Customizing Key Bindings

Customizing Toolbars

Settings Panels

Dialog Box Buttons

Choosing Target Settings

Target Configurations

Code Generation Configurations

Linker Configurations

Editor Configurations

Debugger Configurations

Understanding Plug-in Compilers

Setting a File Extension

Compiling and Linking a Project

Compiling Files

Setting Link Order

Updating a Project

Making a Project

Enabling Debugging

Running a Project

Debugging a Project

Generating a Link Map

Synchronizing Modification Dates

Removing Object Code

Advanced Compile Options

Using Precompiled or Preprocessed Headers

Creating Precompiled Headers

Defining Symbols For C/C++

Defining Symbols For Pascal

Preprocessing Source Code

Disassembling Source Code

Guided Tour of the Message Window

Using the Message Window

Seeing Errors and Warnings

Stepping Through Messages

Correcting Compiler Errors and Warnings

Correcting Linker Errors

Correcting Pascal Circular References

Saving and Printing the Message Window

Locating Errors in Modified Files

Special Library Options (Mac OS)

Import Weak

Initialize Before

Merge Into Output

Preparing for Debugging

Setting Up a Build Target for Debugging

Setting Up a File for Debugging

Generating Symbolics Information

Using the Debugger

Guided Tour of the Debugger

Stack Crawl Window

Source Code Browser Window

Auto-Variables View

Debugger Contextual Menu

Expressions Window

Global Variables Window

Breakpoints Window

Watchpoints Window

Log Window

Variable Window

Array Window

Memory Window

Register Windows

Processes Window

Basic Debugging

Starting Up

Running, Stepping, and Stopping Code

Navigating Code

Breakpoints

Watchpoints

Viewing and Changing Data

Editing Source Code

Expressions

How Expressions are Interpreted

Using Expressions

Example Expressions

Expression Syntax

Troubleshooting

General Problems

Problems Launching the Debugger

Problems Running/Crashing the Debugger

Problems with Breakpoints

Problems with Variables

Problems with Source Files

Debugger Error Messages

CodeWarrior RAD Tools

Class Authoring

Component Model

Creating RAD Projects

RAD Wizards

Java Applet Wizard

Java Application Wizard

Java Bean Wizard

Working with Designs

Adding Designs to a Project

Design View in the Project Window

Designs in the Targets View

Working with Layouts

Creating a Layout

Modifying a Layout

Layout Wizards

Java Frame Wizard

Component Palette

Component Palette Toolbar

Catalog Pop-up Menu

Component Tools

Component Catalog window

Component Catalog Toolbar

Catalog Pane

Component Pane

Component Catalog Contextual Menu

Creating Component Catalogs

Object Inspector

Object Pop-up Menu

Properties Tab

Events Tab

Object Inspector Contextual Menu

Java Swing Components

Component Editors

Menu Editor

Pop-up Menu Editor

Tab Control

Properties View

Methods View

Events View

RAD Windows

New Property Window

New Method Window

New Event Set Window

New Event Set wizard

New Event Window

Commercially Available VCS Plug-ins

Activating VCS Operations

Installing VCS Software

Activating VCS Software

Accessing VCS Features

VCS Menu

Version Control Login Window

VCS Pop-up

Project Window

VCS Messages Window

Common VCS Operations

Getting a File's Status

Modifying a Checked In File

Dealing with `ckid' Resources (Mac OS)

Other Operations

File Menu

Edit Menu

Search Menu

Project Menu

Debug Menu

Data Menu

Browser Menu

Window Menu

Layout Menu

Version Control System (VCS) Menu

Help Menu

Java Exceptions Submenu

Toolbar Submenu

Apple Menu (Mac OS)

Tools Menu (Mac OS)

Scripts Menu (Mac OS)

Editor Extensions Menu (Mac OS)

Info Menu (Solaris)

IDE Default Key Bindings

Mac OS, Solaris, and Linux Modifier Key Legend

File Menu

Edit Menu

Search Menu

Project Menu

Debug Menu

Data Menu

Browser Menu

Miscellaneous

Editor Commands

Catalog

Layout Menu

Window Menu

Source File/Directory Selection

Currently Selected Files/Directories

Destination Directory Selection

File Systems Facility

The File Systems Dialog Box

The File System Options Dialog Box

Keyboard Preferences Dialog Box

Windows

Mac OS

Configuring the Perl Target Settings Panel

Perl Scripting

Special Considerations

StdIn Usage

Avoiding Link Errors